home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / windows / bltcap15.zip / WHATS.NEW < prev   
Text File  |  1992-09-11  |  4KB  |  100 lines
  1.                            What's New For Version 1.5
  2.  
  3. Overview
  4. --------
  5.  
  6. Version 1.5 represents a significant re-write of the script logic the program
  7. generates. When I released version 1.0, I had a good idea how to write the
  8. program, but my knowledge of how Icom's script language REALLY works was
  9. limited.
  10.  
  11. Thanks to the torture testing of the version 1.0 users, I was able to finally
  12. understand how the script should be written. It turns out that my first attempt
  13. was more or less (probably more) wrong. As a result, I threw away the old
  14. code and re-wrote from scratch. Here are briefly the major changes.
  15.  
  16.  
  17. Bltcap Does Windows
  18. -------------------
  19.  
  20. For systems with high speed modems, there was a tendancy for bltcap 1.0 to
  21. scroll bulletins to the screen faster than Windows could handle it. As a
  22. result, captures would often become garbled.
  23.  
  24. This has been fixed in version 1.5. Bltcap can now capture a bulletin one
  25. screen at a time, with a short delay between each screen. These parameters
  26. can be tweeked in the bltcap initialization file to capture a bulletin as
  27. quickly as your system will handle it.
  28.  
  29. The parameters that control this are: nomc, lcmd, delay, and timeout. To
  30. use bltcap safely under Windows, set nomc="Y" and lcmd="%" (this works for
  31. PC Board, others might differ slightly). The delay parameter controls how
  32. long the delay loop is for each screen. The default is 20 (2 seconds); you
  33. can change this to a lower value if Windows can handle a shorter delay.
  34.  
  35. Note that bltcap always generates the delay logic in the custom script. This
  36. was done as a safety measure in the event that you inadvertently capture a
  37. bulletin which gives you a "More" prompt. The previous script would hang on
  38. this.
  39.  
  40. Read bltcap.txt if you want more detail on these parameters, or try toggling
  41. them to different values and check the generated script to see where these
  42. parameters have effect.
  43.  
  44.  
  45. Bltcap Does Doors Too!
  46. ----------------------
  47.  
  48. The previous version of bltcap always required that you be at the main board
  49. prompt. Version 1.5 now handles conferences, mail doors, time deposit doors,
  50. and will keep bashing away until a main board prompt is reached. This makes
  51. it possible to run bltcap anywhere in your job.
  52.  
  53. NOTE TO QMAIL USERS!!! - the standard BIF parameter for a Qmail door is
  54. mmnp="<COMMAND>". While more or less correct, bltcap will not see this
  55. prompt. This is because Qmail issues a second prompt, "Qmail Command? "
  56. immediately following the <COMMAND> message. Running bltcap in a job
  57. following a mail run will not work unless you set mmnp="Qmail Command? " as
  58. this is the only prompt the script can see.
  59.  
  60.                                       - 1 -
  61.  
  62.  
  63.  
  64. Bltcap Handles Conference Specific Bulletins
  65. --------------------------------------------
  66.  
  67. The previous version couldn't really handle conference specific bulletins
  68. without a LOT of tweaking. Version 1.5 now handles them with ease, through
  69. the "include" parameter in the bltcap initialization file. This is best
  70. swown by example:
  71.  
  72. include="5 10 13:1 13:2 27:5"
  73.  
  74. Given the above include line form bltcap.ini, bltcap will capture main board
  75. bulletin #5, main board bulletin #10, conference 13 bulletin #1, conference
  76. 13 bulletin #2 and conference 27 bulletin #5.
  77.  
  78. In other words, just add conference specific bulletins to your include list in
  79. the form conference:bulletin.
  80.  
  81. This generates some very complex script logic. For CRS users, try 13:1 if you
  82. want to see the script code that gets created.
  83.  
  84.  
  85. Bltcap No Longer Kills Icom
  86. ---------------------------
  87.  
  88. Version 1.0 would issue an exit code of 1 if it failed. MISTAKE! Only later
  89. did I discover that Icom would hang up if it received a non-zero return code.
  90. Even though I'd like to signal an error, I'm forced to return 0 to Icom to
  91. keep it happy. You'll have to read the comment that bltcap adds to your
  92. icom.use file to see if it was successful or not.
  93.  
  94.  
  95. Well, that's about all that's new. I've yet to crash the new version (challenge
  96. to all torture testers! ;-) ). But then again, version 1.0 was perfect when I
  97. released it as well...
  98.  
  99.                                       - 2 -
  100.